home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / fax_sstv / wxman20 / wxman.doc < prev    next >
Text File  |  1994-07-22  |  29KB  |  691 lines
  1.  
  2.  
  3.                            WeatherMan:
  4.                  A Radiofacsimile Reception Program
  5.                                for
  6.                        IBM PCs and Compatibles
  7.  
  8.  
  9. Table of Contents
  10.  
  11. (Find topics by searching for the topic title.  Be sure to include the
  12. brackets in the search string.)
  13.  
  14. [Notice]
  15. [I]...........What Is Wefax?
  16. [II]..........How WeatherMan Works
  17. [III].........Connecting a Radio to a Sound Card
  18. [IV]..........Creating a Configuration File
  19. [V]...........Running WeatherMan
  20. [VI]..........WeatherMan Keyboard Commands
  21. [VII].........The SHOWPIC Program
  22. [VIII]........The RAW2PCX Program
  23. [IX]..........WXDEMO.EXE
  24.  
  25. [Appendix 1]..Weather Facsimile Frequencies
  26. [Appendix 2]..Troubleshooting Q&A
  27. [Appendix 3]..Supported Sound Cards
  28. [Appendix 4]..About the Sample Pictures
  29.  
  30.  
  31. [Notice]
  32.                               *****
  33.  
  34. Notice, Part 1-- The Plea for Cold, Hard Cash:
  35.  
  36. The computer programs and documentation described in this document are
  37. neither free, nor are they in the public domain: they are shareware.
  38. In this particular case, the term "shareware" means that you are welcomed
  39. and encouraged to use the programs for a trial period of not more than 30
  40. days.  If, after or during the trial period, you decide to continue
  41. using the programs, you should send a check (drawn on a U.S. bank) or
  42. a U.S. Postal Money Order in the amount of $20.00 (US currency) to the
  43. program's author:
  44.  
  45.                   Paul Hitchcock
  46.                   2309 Blake Street, #308
  47.                   Berkeley, CA 94704
  48.  
  49. Email about the program may be sent to me at
  50.  
  51.                   Internet   : paulhtc@netcom.com
  52.                   Compuserve : 72673,3522
  53.                               *****
  54.  
  55. Please note that this program, unlike many other shareware offerings, is
  56. *not* "cripple-ware"-- it is fully functional.  While it's true that
  57. offering a limited version of a program via shareware might be an incentive
  58. for users to register, I've always disliked the practice.  However,
  59. registered users will go to the "head of the line" as far as support is
  60. concerned.
  61.  
  62. Notice, Part 2-- The Ugly Legal Stuff:
  63.  
  64. The programs and documentation in this package are distributed "as-is",
  65. with no warranty expressed or implied, including, but not limited to,
  66. merchantability or fitness for a particular purpose.  Any and all
  67. damages arising out of the use of the programs and/or documentation
  68. are the responsibility of the purchaser and/or user of the programs
  69. and documentation.
  70.  
  71. All programs and documentation in this package are Copyright (C) 1994
  72. by Paul Hitchcock.
  73.  
  74. "Sound Blaster", "Sound Blaster Pro", and "Sound Blaster 16" are
  75. registered trademarks of Creative Labs, Inc.
  76.  
  77. "PAS 16" and "ProAudio Spectrum" are registered trademarks of
  78. Mediavision, Inc.
  79.  
  80.                               *****
  81.  
  82. [Introduction]
  83.  
  84. WeatherMan is a computer program for IBM PCs and compatibles which,
  85. when used with a Sound Blaster-compatible sound card, lets you receive,
  86. display, and store to disk weather photos and charts of the type
  87. broadcast over the high-frequency (HF) shortwave bands.
  88.  
  89. To use the program you must have the following items:
  90.  
  91. 1) A shortwave receiver, equipped with a beat-frequency
  92.    oscillator (BFO)
  93. 2) A 100% Sound Blaster-compatible sound card
  94. 3) A VGA video card and monitor capable of displaying
  95.    640x480 16-color graphics
  96. 4) An IBM PC or compatible 386/486 computer, running at
  97.    33 MHz or faster
  98. 5) A patch cord or microphone for connecting the shortwave
  99.    receiver to the sound card
  100.  
  101.  
  102. [I]  What Is Wefax?
  103.  
  104. Wefax, or weather facsimile, is a technology for transmitting
  105. photographs and other graphical material via radio.  The process
  106. is fairly straightforward: At the transmitter, an object whose
  107. image is to be transmitted is scanned line-by-line at a constant
  108. rate by an optical sensor; the output of the sensor is used to
  109. control the frequency of an oscillator in such a way that the
  110. oscillator's output is linearly proportional to the amount of light
  111. refected from corresponding areas of the scanned object.  The
  112. frequency of the oscillator ranges from 1500 Hz for pure-black areas
  113. to 2300 Hz for white regions.  This "frequency-modulated subcarrier"
  114. is in turn used to frequency-modulate a radio wave which is then
  115. broadcast.
  116.  
  117. At the receiver the process is reversed: the wefax signal is
  118. demodulated, resulting in a set of tones whose frequencies
  119. are again linearly proportional to the light and dark areas of the
  120. original scanned object.  If an FM receiver is employed to detect
  121. the signal, the original frequencies are faithfully reproduced.
  122. More commonly, however, the signal is demodulated using an AM
  123. receiver equipped with a beat-frequency oscillator (BFO).  While
  124. FM reception generally results in better noise rejection, the BFO
  125. method gives the listener the ability to choose (within limits,
  126. of course) the center frequency of the 800 Hz audio band; this
  127. capability can be very useful when trying to receive a fax in
  128. the presence of an interfering signal.  BFO-based reception is
  129. assumed throughout the remainder of the discussion.
  130.  
  131. For the purpose of this discussion, a wefax broadcast can be
  132. defined by two parameters:  (1) its transmission rate (or "drum
  133. speed")  in lines per minute (lpm) and (2) its index of correlation
  134. (IOC).  The IOC is essentially the ratio of the transmitted
  135. picture's line width to its line height.  At the present time,
  136. nearly all U.S. (and many foreign) wefax broadcasts are transmitted
  137. with a drum speed of 120 lpm and an IOC of 576. There are a number
  138. of other radiofacsimile formats, but the present version of WeatherMan
  139. can only receive faxes broadcast at 120 lpm.
  140.  
  141. A more complete description of weather facsimile broadcasting can
  142. be found in the 1990 edition of the ARRL Handbook.
  143.  
  144. (Note: The term "wefax" is not really appropriate for describing
  145. HF weather facsimile broadcasts, but since "everybody" uses it in
  146. this context, I'll follow the same convention.)
  147.  
  148. [II] How WeatherMan Works
  149.  
  150. The digital sound processor (DSP) chip on sound cards such as the
  151. Sound Blaster provides a number of sound-processing services.
  152. One of these services, DMA (Direct Memory Access) audio recording,
  153. may be integrated into a computer program, giving the program the
  154. ability to record audio signals as a background task.  WeatherMan
  155. uses this facility to insert a line of radiofax information into a
  156. memory buffer at the same time it is processing and displaying the
  157. previously received line.
  158.  
  159. Once the radiofax data is in the computer, WeatherMan determines the
  160. frequency of the audio information by measuring the time interval
  161. between consecutive zero-point crossings of the recorded samples.
  162. Once the frequency has been determined, the program assigns a
  163. proportional color number from 0 through 15 to the frequency, plots
  164. the point, then goes back for more samples.  This process continues
  165. until the program's user takes some intervening action.
  166.  
  167. In it's current incarnation, WeatherMan samples the mic input at a
  168. rate of 10,000 samples per second and uses, on average, 8 samples
  169. per pixel.  From these numbers, one would assume this would yield a
  170. picture 625 pixels wide (5000 samples per half-second line divided
  171. by 8).   Unfortunately, it's not quite that simple, for two principal
  172. reasons:  1) Individual sound card/computer combinations have varying
  173. sampling rates for which allowance must be made, and 2) setting up
  174. and exiting the DMA record procedure requires processor time.  Since
  175. the incoming radiofax transmission does not wait for WeatherMan to
  176. complete its internal housekeeping before sending more data, a certain
  177. amount of information is necessarily going to be lost from each received
  178. line.  How much data is lost?  On average, the amount lost translates to
  179. about two pixels per line.
  180.  
  181. First, the good news-- although two pixels per line are not plotted,
  182. if the picture being received is properly aligned, no useful information
  183. is lost.  The nature of fax transmission requires that data can't
  184. be transmitted over the entire line: for example, a mechanical fax
  185. receiver must be allowed a certain amount of time for the pen or plotting
  186. stylus to return to the margin to begin drawing the next line.
  187.  
  188. Next, the bad news-- compromises had to be made.  In order for
  189. WeatherMan to run on the greatest number of machines, I decided
  190. that the screen resolution should be no greater than 640x480 in
  191. 16 colors.  Unfortunately, since a vertical resolution of 480 pixels
  192. would result in displaying only a small portion of a weather photo,
  193. I also decided that the program would plot only one line for every
  194. two received. Lines are not skipped, however: a smoothing algorithm
  195. is used on every two received lines to produce a smooth-appearing
  196. single line, which is then plotted.  Using this method, about
  197. two-thirds of a complete weather photo can be displayed on a
  198. 640/480 screen.
  199.  
  200. Finally, the completely impartial(but interesting) news-- forget what
  201. was said about white being the highest frequency and black being the
  202. lowest.  In commercial fax receivers, those conditions undoubtedly
  203. obtain.  However, I found that the best results were achieved when
  204. receiving faxes on the other sideband; hence, WeatherMan employs a
  205. reversed palette in which darker colors represent higher frequencies.
  206. As will be seen later on, WeatherMan's configuration file can be
  207. modified to comply with the "standard" if that's what you need.
  208.  
  209. [III] Connecting a Radio to a Sound Card
  210.  
  211. To use WeatherMan, you must connect the audio output of your radio
  212. receiver to the microphone input of your sound card.  But first:
  213.  
  214.  
  215.            *****************************************
  216.            *                                       *
  217.            *     Warning!  Warning!   Warning!     *
  218.            *     Warning!  Warning!   Warning!     *
  219.            *     Warning!  Warning!   Warning!     *
  220.            *                                       *
  221.            *****************************************
  222.  
  223. Got your attention?  Good, because this is very important:  unless
  224. you completely understand what you are doing when you connect any
  225. two pieces of electrical equipment together :
  226.  
  227.      THERE IS AN INHERENT RISK OF PERMANENT DAMAGE TO EITHER OR BOTH
  228.      DEVICES OR TO YOURSELF!!!!
  229.  
  230. For people fortunate enough to have a shortwave receiver equipped
  231. with a mic-level output jack, connecting the radio to a sound card
  232. is simply a matter of stringing a patch cord between the microphone
  233. output of the receiver to the microphone input of the sound card.
  234. I have an old, battery-operated Radio Shack DX-440 which I use for
  235. wefax (yes-- it does have a mic output, albeit an undocumented one)
  236. and this method works just fine.  But a warning-- if your radio is
  237. powered from the AC line and you're not sure if the radio uses an
  238. internal isolation transformer, DO NOT connect it directly to the
  239. sound card, even if there is an output jack.  Use the method below
  240. instead.
  241.  
  242. The easiest and safest way to connect a sound card to a radio is to
  243. plug a microphone into the card's MIC input, then place the active end
  244. of the microphone *very* close to the radio speaker.  Better still, put
  245. the active end of the mike between the earcups of a set of headphones,
  246. then plug the heaphones into the receiver's headphone jack.   Secure the
  247. mike in place with rubber bands, use a little scrap foam rubber for sound
  248. baffling and you're in business.
  249.  
  250. [IV] Using WeatherMan : Creating a Configuration File
  251.  
  252. Now that your radio and sound card are connected together, there's
  253. one more thing you have to do before running WeatherMan: edit the
  254. program's "configuration file", which holds essential details about
  255. your hardware setup and display preferences.  A sample configuration
  256. file is given below (it's a copy of the one supplied with the program
  257. set):
  258.  
  259.  
  260.  1) 59676 <---------------------- sweep delay number
  261.  2) 1050  <---------------------- lowest audio frequency (1050)
  262.  3) 1700  <---------------------- highest audio frequency (1700)
  263.  4) $220  <---------------------- I/O port used by sound card
  264.  5) 5     <---------------------- interrupt used by sound card
  265.  6) 1     <---------------------- DMA channel used by sound card
  266.  7) 0      63      63      63 <-- <color number> <R> <G> <B>
  267.  8) 1      59      59      59      each RGB value must be >= 0 and <= 63
  268.  9) 2      55      55      55
  269. 10) 3      50      50      50
  270. 11) 4      46      46      46
  271. 12) 5      42      42      42
  272. 13) 6      38      38      38
  273. 14) 7      34      34      34
  274. 15) 8      29      29      29
  275. 16) 9      25      25      25
  276. 17) 10     21      21      21
  277. 18) 11     17      17      17
  278. 19) 12     13      13      13
  279. 20) 13      8       8       8
  280. 21) 14      5       5       5
  281. 22) 15      0       0       0
  282.  
  283. Let's go through the list (the line numbers, e.g., "20)", are for
  284. reference only and should not appear in the actual configuration file):
  285.  
  286. Line 1 : "sweep delay number"-  This number is used to change the
  287. "tick rate" of the PC's internal time-of-day clock so WeatherMan can
  288. use it as a picture-synchronizing reference.  When the proper value for
  289. this number is entered into your configuration file, received pictures
  290. are properly aligned vertically with minimum right/left skewing.  The
  291. function of this number is analogous to the "horizontal hold" control
  292. found on older television sets.
  293.  
  294. How do you know what sweep delay number to use?  The number given in
  295. the sample WXMAN.CFG file is only approximate and will probably not
  296. be correct for your setup: you will have to determine the value you
  297. need to use by trial and error.  Fortunately, I can offer some
  298. guidelines:
  299.  
  300. Suppose you are receiving a fax composed of vertical lines that is
  301. supposed to look like this:
  302.  
  303.                     |       |       |
  304.                     |       |       |
  305.                     |       |       |
  306.                     |       |       |
  307.                     |       |       |
  308.  
  309. but instead it looks like this:
  310.  
  311.                     \       \       \
  312.                      \       \       \
  313.                       \       \       \
  314.                        \       \       \
  315.                         \       \       \
  316.  
  317. In this case, the sweep delay number should be INCREASED by pressing
  318. the plus ("+") key.  Note that "+" is entered by pressing the "=" and
  319. SHIFT key simultaneously.
  320.  
  321. Conversely, if the picture looks like this:
  322.  
  323.                         /       /       /
  324.                        /       /       /
  325.                       /       /       /
  326.                      /       /       /
  327.                     /       /       /
  328.  
  329. the sweep delay number should be DECREASED by pressing the minus ("-")
  330. key.
  331.  
  332. You should only have to adjust the sweep delay number once for a
  333. particular sound card/computer combination.  When you exit
  334. WeatherMan, you will be informed of the last sweep delay used by
  335. the program.   Insert this number into your WXMAN.CFG file.
  336.  
  337.  
  338. Lines 2 and 3: "lowest audio frequency" and "highest audio frequency"--
  339. These define the white-to-black frequency range and have two principal
  340. uses: 1) by widening/narrowing the range, you can stretch/compress the
  341. contrast of the received picture, and 2) by  shifting the center of
  342. the range up or down, you can possibly reduce interference caused by
  343. transmissions on adjacent frequencies. Experiment with various
  344. combinations to achieve the best results.  The numbers given are
  345. in cycles per second (Hz).
  346.  
  347. Line 4: Sound card I/O port- If necessary, change this number in
  348. accordance with your particular sound card installation.  Consult
  349. your sound card's reference manual for details.  Also, note that
  350. the prefacing "$" denotes a hexadecimal number.
  351.  
  352. Line 5: Sound card interrupt number- Change if necessary, as in Line 4.
  353.  
  354. Line 6: DMA channel used by the sound card-- Change if necessary, as in
  355. line 4.
  356.  
  357. Lines 7 through 22: color palette- This is pretty self-explanatory.
  358. The default palette is for a 16-level gray scale.
  359.  
  360. The format of the configuration file requires that comments be
  361. separated from the file elements by at least one space. The file
  362. should not contain any empty lines.
  363.  
  364. [V] Running WeatherMan
  365.  
  366. Once you have created a configuration file, WeatherMan is run using
  367. the following syntax:
  368.  
  369.                                WXMAN
  370. or
  371.                     WXMAN <configuration file name>
  372.  
  373. If you choose the first option, "WXMAN", you must have a configuration
  374. file with the name "WXMAN.CFG" located in the same directory as the
  375. program file.  The second option lets you choose the name and path of
  376. a different configuration file.  Suppose, for example, you have a
  377. reversed-palette configuration file named "WXMANREV.CFG" in directory
  378. "CONFIGS" located on drive C:.  You then run the program with the
  379. command "WXMAN C:\CONFIGS\WXMANREV.CFG".
  380.  
  381. With your shortwave receiver turned on and connected to the sound card,
  382. activate the receiver's BFO, then tune in a wefax station.  Adjust the
  383. BFO up or down for the best picture.  When tuning the BFO, it's usually
  384. easiest to start at a high-frequency audio output and work back to the
  385. proper frequency.
  386.  
  387. [VI] WeatherMan Keyboard Commands
  388.  
  389. Once WeatherMan is up and running, you have several commands at your
  390. disposal:
  391.  
  392.                   <C>lear Screen
  393.                   <1>..<9> Delay Picture Reception
  394.                   <BS>  (backspace) Nudge Picture Left/Stop Nudge
  395.                   <P>osition Graphics Cursor
  396.                   <G>rab a Picture
  397.                   <H>elp with Commands
  398.                   <ESC> Exit WeatherMan
  399.                   <+/-> increase/decrease sweep delay
  400.  
  401. Each of the commands is activated by pressing the letter key within
  402. the "<>" symbols. Case is unimportant.
  403.  
  404. <C>lear Screen
  405.  
  406.        Pressing "C" clears the screen and the current image is
  407.        lost forever.  After clearing the screen, the picture will
  408.        probably have to be re-aligned (see below).
  409.  
  410. <1>..<9> Delay Picture Reception
  411.  
  412.        Pressing "1" through "9" causes sampling of the incoming
  413.        fax to be delayed an amount of time equal to 1-9 "ticks"
  414.        of the re-programmed PC real-time clock.  Each tick represents
  415.        an increment of one-tenth of the horiziontal screen width.
  416.        These commands let you "walk" the true edge of the incoming fax
  417.        so that it's close to the left side of the screen.
  418.  
  419. <BS>  (backspace) Nudge Picture Left/Stop Nudge
  420.  
  421.        The "1" through "9" keys move the picture to the left only in
  422.        discrete amounts, so it's possible that you could move a picture
  423.        only to find it doesn't completely align with the left edge of
  424.        the monitor screen.  In such cases, pressing BS will cause the
  425.        picture to start skewing to the left automatically.  This key
  426.        is a toggle switch-- press it once to start the automatic shift
  427.        and when the picture is aligned to your satisfaction, press it
  428.        again to stop the motion.
  429.  
  430. <P>osition Graphics Cursor
  431.  
  432.        After positioning a picture with the "1" through "9" keys,
  433.        and/or the BS key, pressing "P" moves the graphics cursor to
  434.        the top line of the screen, without clearing the screen.
  435.        Previously displayed data will be over-written.
  436.  
  437. <G>rab a Picture
  438.  
  439.        Pressing "G" saves the currently-displayed picture to disk.
  440.        The saved picture is time- and date-stamped at the bottom of
  441.        the screen.  Saved picture files are given the name
  442.        "GRABxxx.RAW", where "xxx" denotes the number of the saved
  443.        picture.  When WeatherMan starts up, it searches the current
  444.        directory for previously-saved pictures and sets its first file
  445.        name to the next highest number to avoid overwriting old files.
  446.  
  447.        When a picture is saved to disk, the timing relationships in
  448.        the PC become somewhat unsettled for fax reception.  When this
  449.        occurs, you'll notice the new data being plotted will start
  450.        skewing fairly rapidly to the right.  After a few such lines
  451.        are drawn, the picture will again become synchronized.  You
  452.        can hasten re-synchronization by pressing BS twice, or by
  453.        clearing the screen.
  454.  
  455. <H>elp
  456.  
  457.        Pressing "H" displays a command summary.  No fax data is
  458.        received or displayed while the "H" command is in effect.
  459.        Press any key to exit the help screen.
  460.  
  461. <ESC> Exit WeatherMan
  462.  
  463.        Pressing the escape key unconditionally exits the program;
  464.        you are not prompted to save the picture first.
  465.  
  466. <+/-> Increase/Decrease sweep delay
  467.  
  468.       These keys are used to adjust the sweep delay, as explained
  469.       above.
  470.  
  471. [VII] The SHOWPIC program
  472.  
  473. Having saved a bunch of pictures to disk, it would be nice to see what
  474. they looked like again, wouldn't it?  That's the purpose of SHOWPIC
  475. and its syntax is
  476.  
  477.          SHOWPIC [-p] <picture file> <picture file>...
  478.  
  479. where the optional -p switch loads a palette from the file SHOWPIC.PAL.
  480. The format of SHOWPIC.PAL is the same as in lines 7 through 22 of the
  481. configuration file.  See the sample palette file for details.
  482.  
  483. Example 1:
  484.  
  485.            SHOWPIC GRAB0.RAW GRAB11.RAW GRAB2.RAW
  486.  
  487. displays the pictures GRAB0.RAW, GRAB11.RAW, and GRAB2.RAW consecutively
  488. using the built-in gray-scale palette.
  489.  
  490. Example 2:
  491.  
  492.            SHOWPIC -p GRAB1.RAW TEST.RAW
  493.  
  494. displays the two given pictures using the palette contained in SHOWPIC.PAL.
  495. You can move to the next picture in the set at any time by pressing any key.
  496.  
  497. WeatherMan's RAW picture file format is exceedingly simple, consisting
  498. of a file of 640*480=307,200 bytes, with each byte representing a
  499. color number in the 0 to 15 range. The file is a record of consecutive
  500. pixel values starting at the upper left-hand side of the screen (0,0)
  501. and extending to the lower right-hand side (639,479).  This format
  502. should make it easy for you to write your own programs for manipulating
  503. captured picture data.
  504.  
  505. The utility program RAW2PCX.EXE (see section [VIII]) can be used to
  506. convert the RAW format into the PCX format used by many PC
  507. paint/image-processing programs.
  508.  
  509. [VIII] The RAW2PCX program
  510.  
  511. To convert a picture file to a PCX graphics file use either of the commands
  512.  
  513.                  RAW2PCX  <input file name>, or
  514.            RAW2PCX  <input file name>  <output file name>
  515.  
  516. Example 1:
  517.                RAW2PCX GRAB0.RAW
  518.  
  519. This command creates a new file "GRAB0.PCX" in the PCX format.
  520.  
  521. Example 2:
  522.                RAW2PCX GRAB0.RAW  TEST.PCX
  523.  
  524. Same result as in Example 1, but the output file is named "TEST.PCX"
  525. instead.
  526.  
  527. Warning: RAW2PCX will overwrite any existing file having the same
  528. name as the output file.
  529.                               *****
  530. [IX] WXDEMO.EXE
  531.  
  532. Wefax broadcasts have a very distinctive sound and once you've heard
  533. one, you'll probably never forget what it sounds like; unfortunately,
  534. the sound is difficult to describe in words.  That's where the WXDEMO
  535. program comes in.
  536.  
  537. Syntax:
  538.  
  539.      WXDEMO <picture file>
  540.  
  541. WXDEMO takes a single argument, the name of a picture file, then
  542. simulates the reception of the picture through your sound card and on
  543. your monitor.  If you've never heard a fax transmission before, WXDEMO
  544. should help you learn what to listen for as you tune through the
  545. shortwave bands.  Keep in mind that this simulated reception will be
  546. noisier than the original signal-- this results from approximating
  547. the original 8-bit audio values by the 4-bit pixel values.
  548.  
  549. [Appendix 1] Weather Facsimile Frequencies.
  550.  
  551. The following is a very small list of stations that transmit weather
  552. photos and charts during the day.  It is not at all inclusive: there
  553. are literally dozens of other stations across the HF bands.
  554. (All frequencies are in kilohertz.)  If you have Internet access, drop
  555. me a line at paulhtc@netcom.com and I'll be happy to send you a larger
  556. list.
  557.  
  558. Frequency (KHz)     Location
  559. ---------          ---------
  560.   6453             California
  561.   8682             California
  562.   9090             California
  563.  11090             Hawaii
  564.  16135             Hawaii
  565.   8080             Virginia
  566.  15959             Virginia
  567.  20015             Virginia
  568.  
  569. [Appendix 2] Troubleshooting Q&A
  570.  
  571. What WeatherMan is and isn't:
  572.  
  573. WeatherMan is a program to decode and display radiofax signals, nothing
  574. more and nothing less.  When presented with a high-quality, low-noise
  575. signal, the program will reproduce a fairly good image of the transmitted
  576. picture.
  577.  
  578. WeatherMan does not, in any way, enhance the receiving capabilites of
  579. a shortwave receiver.  In fact, the opposite is probably true-- Computers
  580. and their peripherals are notorious for generating broad-spectrum
  581. radio-frequency interference.  It is entirely likely that you will
  582. not be able to receive some stations while the computer is running,
  583. even stations that would otherwise be received just fine.
  584.  
  585. Several things can be done to improve reception:  Locate the radio and
  586. its antenna as far from the computer as possible.  Use a high-output
  587. microphone.  Use a good long-wire antenna.   Don't use a light-dimmer,
  588. electric motors, or fluorescent lights near the radio or its antenna.
  589. Pray that the ionosphere cooperates-- all the usual stuff.
  590.  
  591. I should also mention the possibility of taping fax transmissions
  592. while the computer is off for decoding and displaying at a later time.
  593. While common audio tape decks have insufficient speed regulation
  594. to be very useful in this regard, some modern VCRs are also designed
  595. to function as high-quality audio recorders.  (I have a Toshiba VCR that
  596. I've used for just this purpose.)  If you decide to try this, you'll
  597. probably have to change the sweep delay number to achieve good results.
  598. VCRs are fairly precise instruments, but they're not always accurate
  599. with regard to playback timing.
  600.  
  601. Now on to the questions.
  602.  
  603.  
  604. Q: Why isn't anything being displayed?
  605.  
  606. Make certain your radio is turned on and the BFO is activated.
  607. Check the connection between the radio output and sound card mic
  608. input. If you have an SBPro, an SB16, or a MediaVision PAS16 card,
  609. use the appropriate mixer command to set the microphone level to
  610. maximum sensitivity before running WeatherMan.
  611.  
  612. Q: Why does the picture look like a photo negative?
  613.  
  614. Either you have loaded a reversed palette in the configuration file
  615. or you are tuned to the wrong sideband.  Adjust the file or the BFO
  616. accordingly.
  617.  
  618. Q: Why is the picture grainy?
  619.  
  620. The signal may be weak, or there may be a source of interference nearby,
  621. such as an electric motor, fluorescent light, or the like.  Use a good
  622. antenna and/or increase the mic input level, and/or remove the source
  623. of the noise.
  624.  
  625. Q: Why is the picture "ghosty"?
  626.  
  627. Just like television, if a signal is received along two or more paths
  628. having different effective lengths, you'll get ghosts.  There's no
  629. cure, except perhaps to re-orient the receiving antenna.
  630.  
  631. Q: Why are there 30 wavy vertical lines across the picture?
  632.  
  633. You're picking up 60 Hz (power line) interference from somewhere,
  634. possibly from a ground-fault loop.  Try transformer-coupling the
  635. receiver to the sound card and make sure you're using a good quality
  636. shielded cable.
  637.  
  638. Q: I've set the "sweep delay" constant.  Why do my pictures still come
  639. out slightly skewed at times?
  640.  
  641. Because of variations in sound card sampling rates and since the PC's
  642. internal clock has a finite resolution, it's unlikely that your pictures
  643. will come out perfectly square.  However, any skewing in which the
  644. picture is off by more than a few pixels is an indication that the
  645. sweep delay constant is not properly adjusted.
  646.  
  647. Q: I get great reception until I turn on the computer.  What gives?
  648.  
  649. The computer is a wonderful source of radio waves.  Keep the antenna
  650. as far as possible from the computer and connect it to your radio
  651. with coax.  The coax shield should be connected to a good ground.
  652.  
  653. Q: When my radio is on, why do I hear Skippy the Clown urging me to
  654. do bad things?
  655.  
  656. Uh huh... That's kind of out of my area of expertise...
  657.  
  658. [Appendix 3] Supported Sound Cards
  659.  
  660. WeatherMan has been tested extensively using the following sound cards:
  661.  
  662.          1. Sound Blaster 1.5
  663.          2. Sound Blaster Pro
  664.          3. Sound Blaster 16
  665.          4. ProAudio Spectrum 16 (PAS16)
  666.  
  667. The program *may* run on other "100% Sound Blaster compatible" cards,
  668. but I can't guarantee that it will.  At the present time, I intend to
  669. support only the cards listed above.
  670.  
  671. [Appendix 4] About the Sample Pictures
  672.  
  673. The sample pictures were received using the following extremely
  674. non-ideal setup:
  675.  
  676. Radio      : Radio Shack DX-440
  677. Sound Card : ProAudio Spectrum 16, Sound Blaster Emulation
  678. Antenna    : 25-ft. random wire antenna, located indoors
  679. Location   : Third floor of an apartment building
  680. Problems   : 1) antenna only 6 ft. from computer
  681.              2) power company transformer about 50 ft away
  682.                 from computer.
  683.  
  684. Even with the setup above, I think the pictures are pretty good; I'll
  685. leave it up to you to imagine what they might have been like using an
  686. excellent shortwave receiver and a good antenna.
  687.  
  688.                           ***************
  689.  
  690. Thanks for trying WeatherMan!
  691.